home *** CD-ROM | disk | FTP | other *** search
/ The X-Philes (2nd Revision) / The X-Philes Number 1 (1995).iso / xphiles / hp48hor1 / usrlib.doc < prev    next >
Text File  |  1995-03-31  |  7KB  |  141 lines
  1. [Note: this is users' comments; see USRLIB.TXT for HP's documentation.  -jkh-] 
  2.  
  3. Author: Joel Nevison; replies by Preston Brown & David Ochs. 
  4.   Subj: USRLIB 
  5.   Date: Fri Jul 27 1990 07:01  
  6.  
  7. Hi folks. 
  8. I finally got USRLIB going, after fussing with a pc clone that apparently 
  9. isn't configured correctly for the USRLIB program. (Crashed hard) 
  10. Using libraries to make programs hidden, but globally accessible is great! 
  11. I have a few programs that I access from redefined keys and I really 
  12. don't need to modify them or even see their names in VAR. 
  13. These are perfect candidates for library objects. 
  14.  
  15. Some observations:  
  16. 1)I had to send my directory to the pc in binary mode, but had to 
  17.   receive the library back in ascii. 
  18. 2)The library detaches itself whenever I do a system halt (ON C). 
  19. 3)I put some general utilities in a library that are used by a number 
  20.   of other programs and I noticed that the other programs can't use 
  21.   the library routine unless I edit them after the library has been 
  22.   attached. (Ditto with key definitions) 
  23. 4)If I make more than one library they can't call each other's routines.  
  24. 5)I saved about 400 bytes by putting 6k of stuff into a library. 
  25.  
  26. Some questions: 
  27. 1)Does anybody know of any ways to work around or minimize the above 
  28.   phenomena?  Especially 3 and 4 above. 
  29. 2)I have not hooked up to the hp bulletin board, is there any info 
  30.   regarding USRLIB that I'm missing?  Any other good stuff from  
  31.   there that hasn't made it to comp.sys.handhelds or the mailing list? 
  32. 3)what kind of things are others out there doing with libraries? 
  33.  
  34. Joel 
  35.  
  36. ---------- 
  37.   Resp: 1 of 2 by prestonb at hpcvra.CV.HP.COM 
  38. Author: [Preston Brown] 
  39.   Date: Fri Jul 27 1990 09:02  
  40.  
  41. 2)The library detaches itself whenever I do a system halt (ON C). 
  42.  
  43. Include an object named $CONFIG in the library which has the attach 
  44. command.  The $CONFIG will be executed whenever a system halt is 
  45. executed. 
  46.  
  47. Preston 
  48.  
  49. ---------- 
  50.   Resp: 2 of 2 by daveo at hpcvra.CV.HP.COM 
  51. Author: [Dave Ochs] 
  52.   Date: Fri Jul 27 1990 17:02  
  53.  
  54. >3)I put some general utilities in a library that are used by a number 
  55. >  of other programs and I noticed that the other programs can't use 
  56. >  the library routine unless I edit them after the library has been 
  57. >  attached. (Ditto with key definitions) 
  58. > 
  59. >4)If I make more than one library they can't call each other's routines.  
  60. ... 
  61. >1)Does anybody know of any ways to work around or minimize the above 
  62. >  phenomena?  Especially 3 and 4 above. 
  63.  
  64. These two questions are related. 
  65.  
  66. When you enter or edit a program, the program is parsed and compiled as it is 
  67. created from the edit line.  More specifically, references to other objects may 
  68. be compiled in several forms depending on the current state of the calculator 
  69. WHEN THE PROGRAM IS COMPILED.  If your program is \<< abc \>>, the compiler 
  70. first looks for an object named 'abc' in the current directory, then it looks 
  71. for an object 'abc' in any libraries attached to the current directory.  If no 
  72. matches are found, the same search occurs in the parent directory, then its 
  73. parent, etc.  until you reach HOME. 
  74.  
  75. If a user object is found (or no match is found), the reference is stored as a 
  76. name (which will be evaluated at run time).  If an object in a library is 
  77. found, the reference is stored as an XLIB name.  At runtime, the specified XLIB 
  78. object is searched for ... if it isn't there, the program will error. 
  79.  
  80. In question 3 above, you must recompile each program that references an XLIB 
  81. object in order to change the variable names into libarary XLIB names.  The 
  82. following program, which I will call COMPDIR, will recompile each object in the 
  83. current directory by converting each into a string and then back again. 
  84.  
  85. \<<  
  86.     VARS OBJ\-> 1 SWAP 
  87.     START 
  88.         DUP RCL \->STR OBJ\-> SWAP STO 
  89.     NEXT 
  90. \>> 
  91.  
  92. It will be easiest if you have a $CONFIG program for each library of the form 
  93. \<< 800 ATTACH \>>, where 800 is the library id; otherwise you will need to 
  94. re-attach the library every time the HP48 warmstarts (which occurs after you 
  95. store a library in a port).  The $CONFIG program runs each time the calculator 
  96. warmstarts, saving you the bother of re-attaching.  THE INSTRUCTIONS BELOW 
  97. ASSUME THAT YOUR LIBARIES AUTO-ATTACH. 
  98.  
  99. It is also possible to have two libraries refer to each other.  An example 
  100. would probably make it clearest.  I will create two libraries, ALIB and BLIB. 
  101. After debugging the programs, the objects that will in each library should be 
  102. moved into separate directories (e.g.  directories 'A' and 'B').  The following 
  103. procedure works ...  it is assumed that you already know how to transfer 
  104. directories/libraries in binary form, etc. 
  105.  
  106. 1.  Transfer directory A to your PC, and create library ALIB with 'usrlib'. 
  107.     References in ALIB to routines in ALIB are now XLIB names. 
  108. 2.  Transfer ALIB to your HP 48, and store it in port 0.  Turn your HP48 
  109.     off and on (it will warmstart and clear the stack). 
  110. 3.  Run COMPDIR on the B directory.  References in directory B to routines 
  111.     in ALIB are now XLIB names.  
  112. 4.  Transfer directory B to your PC, and create library BLIB with 'usrlib'. 
  113.     References in BLIB to routines in BLIB or ALIB are now XLIB names. 
  114. 5.  DETACH and PURGE library ALIB from port 0 (you will probably want to 
  115.     remove the user variable version too). 
  116. 6.  Transfer BLIB to your HP 48, and store it in port 0.  Turn your HP48 
  117.     off and on.   
  118. 7.  Run COMPDIR on the A directory.  References in directory A to routines 
  119.     in BLIB are now XLIB names. 
  120. 8.  Transfer directory A to your PC, and create library ALIB with 'usrlib'. 
  121.     References in ALIB to routines in ALIB or BLIB are now XLIB names. 
  122. 9.  Transfer ALIB to your HP 48, and store it in port 0.  Turn your HP48 
  123.     off and on.  
  124.  
  125. Some thoughts: 
  126.  
  127. -   Don't mess with the A or B directories while doing this procedure, since 
  128.     XLIB names depend on variable order within the directory, among other 
  129.     things. 
  130. -   Neither library can be completely functional alone, since they each refer 
  131.     to the other, so why have two? 
  132. -   It is MUCH easier to create "nested" libraries, where lib B uses routines 
  133.     from lib A, lib C uses routines from libs A and B, etc.  It is also much 
  134.     easier to remember their relationship.  A can be used independently, B 
  135.     requires A, C requires B and A, etc. 
  136. -   Enough already. 
  137.  
  138.  
  139. Dave Ochs 
  140. daveo@hp-pcd.hp.com 
  141.